# HTML DOM images Collection

Document Object

## Example

Find out how many <img> elements there are in the document:

var x = document.images.length;

The result of x will be:

3
Try it yourself »

More "Try it Yourself" examples below.

## Definition and Usage

The images collection returns a collection of all <img> elements in the document.

Note: The elements in the collection are sorted as they appear in the source code.

Note: The images collection does not return a collection of <input> elements with type="image".

Tip: Also look at the Image Object.

## Browser Support

Collection |  |  |  |  |
--- | --- | --- | --- | --- | ---
images | Yes | Yes | Yes | Yes | Yes

## Syntax

document.images

## Properties

Property | Description
--- | ---
length | Returns the number of <img> elements in the collection. Note: This property is read-only

## Methods

Method | Description
--- | ---
[index] | Returns the <img> element from the collection with the specified index (starts at 0). Note: Returns null if the index number is out of range
item(index) | Returns the <img> element from the collection with the specified index (starts at 0). Note: Returns null if the index number is out of range
namedItem(id) | Returns the <img> element from the collection with the specified id. Note: Returns null if the id does not exist

## Technical Details

DOM Version: | Core Level 1 Document Object
Return Value: | An HTMLCollection Object, representing all <img> elements in the document. The elements in the collection are sorted as they appear in the source code

## More Examples

## Example

[index]

Get the URL of the first <img> element (index 0) in the document:

var x = document.images[0].src;

The result of x will be:

http://www.w3schools.com/jsref/klematis.jpg
Try it yourself »

## Example

item(index)

Get the URL of the first <img> element (index 0) in the document:

var x = document.images.item(0).src;

The result of x will be:

http://www.w3schools.com/jsref/klematis.jpg
Try it yourself »

## Example

namedItem(id)

Get the URL of the <img> element with id="myImg" in the document:

var x = document.images.namedItem("myImg").src;

The result of x will be:

http://www.w3schools.com/jsref/smiley.gif
Try it yourself »

## Example

Add a black dotted border to the first <img> element in the document:

document.images[0].style.border = "10px dotted black";
Try it yourself »

## Example

Loop through all <img> elements in the document, and output the URL (src) of each image:

var x = document.images;
var txt = "";
var i;
for (i = 0; i < x.length; i++) {
txt = txt + x[i].src + "<br>";
}

The result of txt will be:

http://www.w3schools.com/jsref/klematis.jpg
http://www.w3schools.com/jsref/klematis2.jpg
http://www.w3schools.com/jsref/smiley.gif
Try it yourself »

## Related Pages

JavaScript reference: HTML DOM Image Object

HTML tutorial: HTML Images

HTML reference: HTML <img> tag

Document Object

### WEB HOSTING

UK Reseller Hosting

### WEB BUILDING

FREE Website BUILDER Free HTML5 Templates

### W3SCHOOLS EXAMS

HTML, CSS, JavaScript, PHP, jQuery, XML, and ASP Certifications

### SHARE THIS PAGE

### Color Picker

### HTML/CSS

HTML Tutorial HTML5 Tutorial CSS Tutorial CSS3 Tutorial Bootstrap Tutorial

### JavaScript

JavaScript Tutorial jQuery Tutorial jQuery Mobile Tutorial AngularJS Tutorial AJAX Tutorial JSON Tutorial

### Graphics

Canvas Tutorial SVG Tutorial Google Maps Tutorial

### Server Side

SQL Tutorial PHP Tutorial ASP Tutorial ASP.NET Tutorial VBScript Tutorial AppML Tutorial

### Web

Web Building Web Statistics Web Certification

### XML

XML Tutorial DTD Tutorial Schema Tutorial XML DOM Tutorial XPath Tutorial XSLT Tutorial XQuery Tutorial XSL-FO Tutorial RSS Tutorial WSDL Tutorial

### HTML/CSS

HTML Tag Reference HTML Event Reference HTML Color Reference CSS 1,2,3 Reference Bootstrap Reference

### JavaScript

JavaScript Reference HTML DOM Reference jQuery Reference jQuery Mobile Reference Google Maps Reference

### Server Side

PHP Reference SQL Reference ASP Reference VBScript Reference Razor Reference ASP.NET Reference

### XML

XML DOM Reference XSLT Reference XSL-FO Reference XPath Reference XQuery Reference Schema Reference RSS Reference SVG Reference

### HTML Charsets

HTML Character Sets HTML ASCII HTML ANSI HTML Windows-1252 HTML ISO-8859-1 HTML Symbols HTML UTF-8

### HTML/CSS

HTML Examples CSS Examples

### Browser Scripting

JavaScript Examples HTML DOM Examples jQuery Examples jQuery Mobile Examples AngularJS Examples AJAX Examples

### Server Scripting

PHP Examples ASP Examples VBScript Examples Razor Examples .NET Examples

### XML Languages

XML Examples DTD Examples XML DOM Examples XSL Examples XSLT Examples XPath Examples XQuery Examples Schema Examples RSS Examples SVG Examples